home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / dev / gcc / ixemsdk.lha / man / cat3 / fread.0 < prev    next >
Text File  |  1996-09-02  |  2KB  |  43 lines
  1.  
  2. FREAD(3)                   UNIX Programmer's Manual                   FREAD(3)
  3.  
  4. NNAAMMEE
  5.      ffrreeaadd, ffwwrriittee - binary stream input/output
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<ssttddiioo..hh>>
  9.  
  10.      _s_i_z_e___t
  11.      ffrreeaadd(_v_o_i_d _*_p_t_r, _s_i_z_e___t _s_i_z_e, _s_i_z_e___t _n_m_e_m_b, _F_I_L_E _*_s_t_r_e_a_m)
  12.  
  13.      _s_i_z_e___t
  14.      ffwwrriittee(_c_o_n_s_t _v_o_i_d _*_p_t_r, _s_i_z_e___t _s_i_z_e, _s_i_z_e___t _n_m_e_m_b, _F_I_L_E _*_s_t_r_e_a_m)
  15.  
  16. DDEESSCCRRIIPPTTIIOONN
  17.      The function ffrreeaadd() reads _n_m_e_m_b objects, each _s_i_z_e bytes long, from the
  18.      stream pointed to by _s_t_r_e_a_m, storing them at the location given by _p_t_r.
  19.  
  20.      The function ffwwrriittee() writes _n_m_e_m_b objects, each _s_i_z_e bytes long, to the
  21.      stream pointed to by _s_t_r_e_a_m, obtaining them from the location given by
  22.      _p_t_r.
  23.  
  24. RREETTUURRNN VVAALLUUEESS
  25.      The functions ffrreeaadd() and ffwwrriittee() advance the file position indicator
  26.      for the stream by the number of bytes read or written.  They return the
  27.      number of objects read or written.  If an error occurs, or the end-of-
  28.      file is reached, the return value is a short object count (or zero).
  29.  
  30.      The function ffrreeaadd() does not distinguish between end-of-file and error,
  31.      and callers must use feof(3) and ferror(3) to determine which occurred.
  32.      The function ffwwrriittee() returns a value less than _n_m_e_m_b only if a write er-
  33.      ror has occurred.
  34.  
  35. SSEEEE AALLSSOO
  36.      read(2),  write(2)
  37.  
  38. SSTTAANNDDAARRDDSS
  39.      The functions ffrreeaadd() and ffwwrriittee() conform to ANSI C3.159-1989 (``ANSI
  40.      C'').
  41.  
  42. BSD Experimental                 March 8, 1994                               1
  43.